SherbyNet - /page/wikibook/entry.mu

Micron Document

<!DOCTYPE html>

<title>Annotation (Java)</title>

</head>

<h1 id="firstHeading" class="firstHeading mw-first-heading"><span class="mw-page-title-main">Annotation (Java)</span></h1>

</header>

</div>

<p>En programmation, une <b><a href="Annotation_(informatique)" title="Annotation (informatique)">annotation</a> Java</b> est une façon d'ajouter des <a href="M%C3%A9ta-donn%C3%A9e" class="mw-redirect" title="Méta-donnée">méta-données</a> à un <a href="Code_source" title="Code source">code source</a> <a href="Java_(langage)" title="Java (langage)">Java</a>. Elles peuvent être ajoutées aux classes, méthodes, attributs, paramètres, <a href="Variable_locale" title="Variable locale">variables locales</a> et paquets.

</p>

<div class="mw-heading mw-heading2"><h2 id="Historique_des_annotations_Java">Historique des annotations Java</h2></div>

<p>Les annotations Java ont été introduites en 2002 à travers le <a href="Java_Community_Process" title="Java Community Process">JCP</a> (JSR-175) et ont été approuvées en <time class="nowrap" datetime="2004-09" data-sort-value="2004-09">septembre 2004</time>. Les annotations sont disponibles avec le <a href="Environnement_d'ex%C3%A9cution_Java" title="Environnement d'exécution Java">JDK</a> version 1.5.

</p><p>Elles ont été introduites en tant qu'alternative aux fichiers de configuration <a href="Extensible_Markup_Language" title="Extensible Markup Language">XML</a>. Elles trouvent leurs sources dans les libellés ajoutés directement dans la documentation Java (<a href="Javadoc" title="Javadoc">Javadoc</a>) qui sont ensuite traitées par des outils tels que <a href="XDoclet" title="XDoclet">XDoclet</a> pour générer les <a href="Fichier_de_configuration" title="Fichier de configuration">fichiers de configuration</a> XML. Ceci évite d'écrire ces fichiers à la main car c'est un procédé ennuyeux et sujet à erreur.

</p><p>Contrairement aux libellés <a href="XDoclet" title="XDoclet">XDoclet</a>, les annotations Java peuvent (si besoin) être accessibles au programmeur lors de l'exécution du programme grâce à la <a href="R%C3%A9flexion_(informatique)" title="Réflexion (informatique)">réflexion</a>.

</p>

<div class="mw-heading mw-heading2"><h2 id="Comment_les_annotations_Java_sont_traitées"><span id="Comment_les_annotations_Java_sont_trait.C3.A9es"></span>Comment les annotations Java sont traitées</h2></div>

<p>Lors de la compilation des codes sources, le <a href="Compilateur" title="Compilateur">compilateur</a> Java stocke les méta-données d'annotation dans les fichiers classes. Plus tard, la <a href="Machine_virtuelle_java" class="mw-redirect" title="Machine virtuelle java">JVM</a> ou d'autres programmes peuvent accéder à ces méta-données pour déterminer comment interagir avec les composants du programme ou changer leur comportement.

Les annotations (que vous pouvez créer) peuvent être elles-mêmes annotées avec une annotation <code>Retention</code> qui indique si cette annotation doit être embarquée dans le fichier classe, accessible dans l'environnement d'exécution ou simplement rester au niveau du code source (TODO).

</p>

<div class="mw-heading mw-heading2"><h2 id="Syntaxe_de_l'annotation"><span id="Syntaxe_de_l.27annotation"></span>Syntaxe de l'annotation</h2></div>

<p>La déclaration des annotations est une variante des libellés ajoutés aux commentaires par le passé.

Les annotations prennent la forme d'une déclaration d'interface précédée du caractère <i>@</i>, et facultativement suivies de méta-annotations, comme montré ci-dessous :

</p>

<pre> @Retention(RetentionPolicy.RUNTIME)

@Target({ElementType.METHOD})

</pre>

<p>Dans cet exemple, <b>Retention</b> et <b>Target</b> sont des exemples d'annotations.

</p><p><br>

Les annotations ne faisant rien de particulier elles-mêmes, il faut ensuite écrire du code Java spécifique pour tirer parti des annotations définies par le programmeur. Ce code peut être exécuté soit lors de la compilation (ex: <a rel="nofollow" class="external text" href="http://projectlombok.org/">project lombok</a>), soit lors de l'exécution comme avec les annotations <a href="Hibernate" title="Hibernate">Hibernate</a> pour la <a href="Persistance_(informatique)" title="Persistance (informatique)">persistance</a>.

</p>

<div class="mw-heading mw-heading2"><h2 id="Voir_aussi">Voir aussi</h2></div>

<ul><li><a href="Java_(langage)" title="Java (langage)">Java (langage)</a></li>

<li><a href="Model_driven_architecture" title="Model driven architecture">Model driven architecture</a></li>

<li><a href="Machine_virtuelle_Java" title="Machine virtuelle Java">Machine virtuelle Java</a></li></ul>

<div class="mw-heading mw-heading2"><h2 id="Références"><span id="R.C3.A9f.C3.A9rences"></span>Références</h2></div>

<ul><li><span class="ouvrage"><abbr class="abbr indicateur-langue" title="Langue : anglais">(en)</abbr> « <a rel="nofollow" class="external text" href="http://www.jcp.org/en/jsr/detail?id=175%20JSR%20175"><cite style="font-style:normal;" lang="en">A Metadata Facility for the JavaTM Programming Language</cite></a> »</span></li></ul>

<ul id="bandeau-portail" class="bandeau-portail"><li><span class="bandeau-portail-element"><span class="bandeau-portail-icone"><span class="noviewer" typeof="mw:File"></span></span> <span class="bandeau-portail-texte">Portail de la programmation informatique</span> </span></li> </ul></div><div><div class="zim-footer">

Cet article est issu de <a class="external text" title="Dernière modification le 2021-08-07" href="https://fr.wikipedia.org/wiki/?title=Annotation_(Java)&oldid=185307617">Wikipédia</a>. Sauf mention contraire, le texte est disponible sous <a class="external text" href="https://creativecommons.org/licenses/by-sa/4.0/deed.fr">Creative Commons Attribution-Share Alike 4.0</a>. Des conditions supplémentaires peuvent s’appliquer aux fichiers multimédias.

</div>

</div></div>

</div>

</main>

</div>

</body></html>